Inside Macintosh: Programming With JManager /

Chapter 2 - JManager Reference / JManager Functions

Applet Control Functions /

JMGetAppletName

Returns the name of an applet.

OSStatus JMGetAppletName (
                     JMAppletLocatorRef locatorRef, 
                     UInt32 appletIndex, 
                     char* buffer, 
                     UInt32 bufferLength);

locatorRef

The applet locator that contains the retrieved HTML text.

appletIndex

The index number of the applet you want to query.

buffer

A pointer to the applet name. On return, this parameter is the name of the applet.

bufferLength

The number of bytes in the buffer.

function result

A result code. See "JManager Result Codes" (page 108) for a list of result codes that JManager may return in this field.

DISCUSSION

The appletIndex value is an index number from 0 to appletCount-1, where appletCount is determined by the JMCountApplets function. You must reserve a buffer for the applet's name and pass a pointer to the buffer when you call JMGetAppletName. You can call this function only after successfully retrieving HTML text using the JMNewAppletLocator function.

SEE ALSO

The JMCountApplets function (page 73).

The JMNewAppletLocator function (page 70).

"Finding Applets" (page 10).